fr:faq:documentation
Table des matières
Qu'est-ce qui fait de Dokuwiki un outil si pratique pour la documentation ?
Les wikis sont parfaits pour la documentation
- Facile à installer
- Facile à démarrer: vous pouvez partager rapidement du contenu non terminé et le soumettre à un large public
- Présentation simple et cohérente
- Facile de créer et de maintenir à jour des documents bien structurés:
- en collaborant
- avec un accès facile via le web, avec ou sans compte utilisateur
- facile de modifier, même sans connaissances en HTML
- facile de créer des liens entre les pages
- facile de créer des pages simples et pertinentes
- recherche facile
- possibilité de compléter le contenu par des pages externes
- Pas besoin de demander à un collègue ou un responsable informatique pour modifier quelque chose = moins de résistance pour maintenir la documentation à jour.
Pourquoi DokuWiki est encore mieux
- Facile de modifier:
- possible d'éditer les pages section par section
- Automatismes:
- liens futurs: les liens vers des pages qui n'existent pas encore s'affichent différemment (en rouge avec le thème par défaut)
- liste des liens qui mènent vers la page courante
- indexation performante
- suivi des révisions
- table des matières pour chaque page (désactivable)
- Différentes possibilités d'inclure des exemples de code (avec colorisation syntaxique)
- Outil de gestion des droits d'accès (ACL) et des utilisateurs simple mais performant, de manière graphique (GUI)
- Interface de configuration de DokuWiki et de la majorité des extensions efficace et graphique (GUI), même pour les personnes qui ne maîtrisent pas PHP et les fichiers de configuration
- Données stockées dans des fichiers texte:
- lisible même si le serveur est en rade
- faciles à sauvegarder, par exemple avec un script ou par FTP
- faciles à lire, à modifier, à comparer ou à générer par des outils externes (wiki ou non)
- Plein de petites choses qui rendent la documentation agréable: notes de bas de page, abréviations, colorisation syntaxique
- Beaucoup d'extensions pour répondre à vos besoins spécifiques
- Et plein d'autres choses que j'oublie maintenant…
fr/faq/documentation.txt · Dernière modification : 2020-02-12 09:37 de JeremieFrancois